package com.cencat.user.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.cencat.common.response.PageResponse;
import com.cencat.user.dto.UserRoleDTO;
import com.cencat.user.dto.UserRoleQueryDTO;
import com.cencat.user.vo.UserRoleVO;

import java.util.List;

/**
 * 用户角色关联服务接口
 * @author cencat
 * @since 2024-01-01
 */
public interface UserRoleService {

    /**
     * 分配用户角色
     * @param dto 用户角色DTO
     * @return 是否成功
     */
    Boolean assignUserRoles(UserRoleDTO dto);

    /**
     * 移除用户角色
     * @param dto 用户角色DTO
     * @return 是否成功
     */
    Boolean removeUserRoles(UserRoleDTO dto);

    /**
     * 更新用户角色（先删除再添加）
     * @param dto 用户角色DTO
     * @return 是否成功
     */
    Boolean updateUserRoles(UserRoleDTO dto);

    /**
     * 根据用户ID删除用户角色关联
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @return 是否成功
     */
    Boolean deleteUserRolesByUserId(Long userId, Long tenantId);

    /**
     * 根据角色ID删除用户角色关联
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 是否成功
     */
    Boolean deleteUserRolesByRoleId(Long roleId, Long tenantId);

    /**
     * 根据用户ID查询用户角色详情
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @return 用户角色详情
     */
    UserRoleVO getUserRoleByUserId(Long userId, Long tenantId);

    /**
     * 分页查询用户角色关联
     * @param queryDTO 查询条件
     * @return 用户角色关联分页列表
     */
    PageResponse<UserRoleVO> getUserRolePage(UserRoleQueryDTO queryDTO);

    /**
     * 查询用户角色关联列表
     * @param queryDTO 查询条件
     * @return 用户角色关联列表
     */
    List<UserRoleVO> getUserRoleList(UserRoleQueryDTO queryDTO);

    /**
     * 检查用户是否拥有指定角色
     * @param userId 用户ID
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 是否拥有
     */
    Boolean checkUserHasRole(Long userId, Long roleId, Long tenantId);

    /**
     * 检查用户是否拥有指定角色编码
     * @param userId 用户ID
     * @param roleCode 角色编码
     * @param tenantId 租户ID
     * @return 是否拥有
     */
    Boolean checkUserHasRoleCode(Long userId, String roleCode, Long tenantId);

    /**
     * 根据角色ID列表查询用户ID列表
     * @param roleIds 角色ID列表
     * @param tenantId 租户ID
     * @return 用户ID列表
     */
    List<Long> getUserIdsByRoleIds(List<Long> roleIds, Long tenantId);

    /**
     * 根据用户ID列表查询角色ID列表
     * @param userIds 用户ID列表
     * @param tenantId 租户ID
     * @return 角色ID列表
     */
    List<Long> getRoleIdsByUserIds(List<Long> userIds, Long tenantId);

    /**
     * 统计用户角色关联数量
     * @param tenantId 租户ID
     * @return 数量
     */
    Long getUserRoleCount(Long tenantId);

    /**
     * 统计用户的角色数量
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @return 数量
     */
    Long getRoleCountByUserId(Long userId, Long tenantId);

    /**
     * 统计角色的用户数量
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 数量
     */
    Long getUserCountByRoleId(Long roleId, Long tenantId);

    /**
     * 批量分配角色给多个用户
     * @param userIds 用户ID列表
     * @param roleIds 角色ID列表
     * @param tenantId 租户ID
     * @return 是否成功
     */
    Boolean batchAssignRolesToUsers(List<Long> userIds, List<Long> roleIds, Long tenantId);

    /**
     * 批量移除多个用户的角色
     * @param userIds 用户ID列表
     * @param roleIds 角色ID列表
     * @param tenantId 租户ID
     * @return 是否成功
     */
    Boolean batchRemoveRolesFromUsers(List<Long> userIds, List<Long> roleIds, Long tenantId);

    /**
     * 复制用户角色（将源用户的角色复制给目标用户）
     * @param sourceUserId 源用户ID
     * @param targetUserId 目标用户ID
     * @param tenantId 租户ID
     * @return 是否成功
     */
    Boolean copyUserRoles(Long sourceUserId, Long targetUserId, Long tenantId);

    /**
     * 同步用户角色（根据用户部门、职位等信息自动分配角色）
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @return 是否成功
     */
    Boolean syncUserRoles(Long userId, Long tenantId);
}